home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / rumor14.zip / RUMOR.DOC < prev    next >
Text File  |  1992-05-25  |  5KB  |  116 lines
  1.  
  2.  
  3.    ─────────────────────────────────────────────────────────────────────────
  4.  
  5.            [ Rumor/Quote File Creator v1.4 for T.A.G. v2.6 and above ]
  6.             (C)May 1992 - Written by Paul Deeds - All Rights Reserved
  7.  
  8.  ─────────────────────────────────────────────────────────────────────────────
  9.  
  10.   PURPOSE: Converts  T.A.G. v2.6 questionarre answer files to T.A.G. v2.6
  11.   ~~~~~~~  format quotation file.  This  allows users  to  quickly add to
  12.            your  rumor  or  quote  file  using  built  in  T.A.G.  system
  13.            commands.
  14.  
  15.   Usage: RUMOR <configuration file name>
  16.  
  17.  
  18.   QUICK START
  19.   ~~~~~~~~~~~
  20.   For a  quick  sample  of what  this  program does,  unarchive  it  into a
  21.   directory and type, at your DOS prompt: RUMOR RUMOR.CFG.  It will convert
  22.   the SAMPLEA.TXT (T.A.G. format questionarre answer file) into SAMPLE.TXT,
  23.   a T.A.G. format quotation file.
  24.  
  25.  
  26.   BACKGROUND
  27.   ~~~~~~~~~~
  28.   With the release of version 2.6 of T.A.G. a versitile and powerful feature
  29.   has been added.   Few people understand the capabilities of this addition,
  30.   thus it is little  used.   This program  will help you  take advantage  of
  31.   T.A.G.'s ability to display a random text strings,  as chosen from a file.
  32.   First, to save you time, I will quote the pertinent  information from  the
  33.   T.A.G. v2.6 update documentaion:
  34.  
  35.    Bottom of page 27:
  36.  
  37.       ***  A file  called TAGQUOTE.* may  now be created to  produce an "Your
  38.            quote for the day  is:" during the  logon process just before  the
  39.            bulletin section appears (if active).
  40.  
  41.    Bottom of page 34:
  42.  
  43.       Function  :    Generate random message
  44.       PKey      :    "8"
  45.       PData     :    <Filename>
  46.  
  47.            <Filename>     MS-DOS filename of the message file
  48.  
  49.       This  command chooses  a random  message from  the specified  file and
  50.       displays it to  the user.  The  file is in standard ASCII  format with
  51.       one blank line separating each message.  If the first line of the file
  52.       begins with "~" it is used as the header instead of the standard quote
  53.       of  the day header.   Due to the algorithm  used, longer quotes have a
  54.       better chance of being chosen than shorter ones.
  55.  
  56.  
  57.   Amazing what you can learn from reading the documentation.  Ok, so now you
  58.   want to know how to use this program to take advantage of the new feature.
  59.   I will go step by step through a simple set up, then briefly describe some
  60.   other possibilities.
  61.  
  62.  
  63.   STEP BY STEP SETUP
  64.   ~~~~~~~~~~~~~~~~~~
  65.   1. Copy the RUMOR.CFG and RUMOR.EXE file into your main BBS directory.
  66.   2. Edit the RUMOR.CFG file, the explantion of each of the three lines
  67.      is contained at length in the configuration file.
  68.   3. Add four commands to a menu (main for me) as follows:
  69.  
  70.       A) Pkey: "?"               This command will be called by the user
  71.          PData: @RUMORQ.MSG      when they  want to add a rumor/quote to
  72.                                  your file. Set the security information
  73.          This command needs      as you see fit.   You will need to copy
  74.          to  be  linked  to      the RUMORQ.MSG  file  included  in this
  75.          the next command.       archive  to your  alternate  data files
  76.                                  directory.
  77.  
  78.       B) Pkey: ":"               This  command  should  be  linked  from
  79.          Pdata: RUMOR RUMOR.CFG  command  (A),  it  shells  to  DOS  and
  80.                                  processes the rumor file.
  81.          This command needs
  82.          to hidden.
  83.  
  84.       C) Pkey: "8"               This   command,   when   executed  will
  85.          Pdata: RUMOR.TXT        display  a  random   quote   from   the
  86.                                  RUMOR.TXT file located in the main data
  87.                                  files directory.
  88.  
  89.       D) Pkey: "!"               Set  this  command so  that it is  only
  90.          Pdata: RUMORA.TXT       available to Co-Sysops or very  trusted
  91.                                  users.   It  displays  the  entire  raw
  92.                                  questionarre  file  and  will show  the
  93.                                  user name/time date of each quote/rumor
  94.                                  that was added.
  95.  
  96.   4. Test everything out, if it didn't work you did something wrong, go
  97.      back to step #1 and check your work.
  98.  
  99.   5. Their are obviously many ways that you could expand on the simple set
  100.      up above.   I have my system set up so that each  time a user changes
  101.      menus it displays a quote/rumor. This can be done very easily through
  102.      linked  commands.   I  also  setup a command off the main  menu  that
  103.      allows users to view the entire  processed quote file.   I will leave
  104.      the rest of the possibilities to you.
  105.  
  106.   SUPPORT / INFORMATION
  107.   ~~~~~~~~~~~~~~~~~~~~~
  108.   This program  is released as free ware,  please  distribute it with all
  109.   the files that are included in this archive.   If you find this program
  110.   useful please drop me  some netmail and let me know  that you are using
  111.   it.  I am always open to suggestions  and can be contacted  through the
  112.   T.A.G. echos or on my board:
  113.  
  114.                  Dirty Deeds - 313/646-3776 - 1:120/267@Fidonet
  115.  
  116.